
/**
 * @apiDefine MenuItem
 * @apiSuccess (Menu) {String} name 菜单名称
 * @apiSuccess (Menu) {String} code 菜单编码
 * @apiSuccess (Menu) {String} path 菜单路径
 * @apiSuccess (Menu) {String} icon 菜单图标
 * @apiSuccess (Menu) {String} level 菜单层级
 * @apiSuccess (Menu) {Object[]} [children] 子菜单
 */

/**
 * @apiDefine ResFormat
 * @apiSuccess {Boolean} success true-成功;false-失败
 * @apiSuccess {String} msg 错误提示
 */

/**
 * @apiVersion 1.0.1
 * @api {get} /menu/list 菜单列表
 * @apiName list
 * @apiGroup Menu
 * @apiDescription 菜单列表数据获取
 * 
 * @apiParam {String="1-管理员","0-普通用户"} isAdmin=0
 * 
 * @apiSuccess {Boolean} success true-成功;false-失败
 * @apiSuccess {String} msg 错误提示
 * @apiSuccess {Object[]} data 返回的菜单列表
 * @apiUse MenuItem
 */

/**
 * @apiVersion 1.0.0
 * @api {get} /menu/tree 菜单列表树
 * @apiPermission none
 * @apiName tree
 * @apiGroup Menu
 * @apiDescription 菜单列表数据获取
 * 
 * @apiHeader {String} ulives-token Users unique access-key.
 * 
 * @apiParam {String="1-管理员","0-普通用户"} isAdmin=0 权限身份
 * 
 * @apiSuccessExample {json} success-response
 * {
 *  success: true/false, // 返回的成功或失败的标识
 *  msg: '', // 失败的信息
 *  data: [
 *    {
 *      name:'', // 名称
 *      code: '', // 编码
 *      path: '', // 路径
 *      icon: '', // 图标
 *      level: 1, // 层级
 *      children: [
 *        {
 *          name:'', // 名称
 *          code: '', // 编码
 *          path: '', // 路径
 *          icon: '', // 图标
 *          level: 2, // 层级
 *        }
 *      ]
 *    }
 *  ]
 * }
 */

/**
 * @apiVersion 1.0.0
 * @api {post} /menu/save 菜单新增
 * @apiName save
 * @apiGroup Menu
 * @apiDescription 菜单新增
 * 
 * @apiParam {String} name 菜单名称
 * @apiParam {String} path 菜单路径
 * @apiParam {String} [icon] 菜单图标
 * @apiParam {String} level 菜单层级
 * @apiParam {String} parentCode 父级菜单编码
 * 
 * @apiParamExample {json} Request-Example:
 * {
 *    "name": "首页", // 菜单名称
 *    "path": "/home", // 菜单路径
 *    "icon": "home", // 菜单图标-可为空
 *    "level": 1, // 菜单层级
 *    "parentCode": "0" // 父级菜单编码
 * }
 * 
 * @apiBody {String} name 菜单名称
 * @apiBody {String} path 菜单路径
 * @apiBody {String} [icon] 菜单图标
 * @apiBody {String} level 菜单层级
 * @apiBody {String} parentCode 父级菜单编码
 * 
 * @apiSuccess {Boolean} success true-成功;false-失败
 * @apiSuccess {String} msg 错误提示
 * @apiSuccess {Object} data 菜单信息
 * @apiUse MenuItem
 * 
 * @apiSuccessExample {json} success-response
 * {
 *    success: true/false, // 返回的成功或失败的标识
 *    msg: '', // 失败的信息
 *    data: {
 *      name:'', // 名称
 *      code: '', // 编码
 *      path: '', // 路径
 *      icon: '', // 图标
 *      level: 1, // 层级
 *      parentCode: ""
 *    }
 * }
 */

